home *** CD-ROM | disk | FTP | other *** search
/ Freaks Macintosh Archive / Freaks Macintosh Archive.bin / Freaks Macintosh Archives / Textfiles / Hacking / %C4L%8~1.SIT / ƒlÂMÈ- BBS Hacking Pak #1 / ZTerm_1.0.1.sit / ZTerm_1.0.1 / ZTerm Docs / A. Appendices < prev    next >
Text File  |  1995-10-21  |  12KB  |  242 lines
  1. Appendices
  2.  
  3. Key Sequences
  4.  
  5. This table shows the many command key equivalents you can use in ZTerm.
  6.  
  7. Cmd-A - Select All.
  8. Cmd-B - Send a BREAK.
  9. Cmd-Shift-B - Send a long BREAK.
  10. Cmd-C - Copy selection to clipboard.
  11. Cmd-D - Open dialing directory.
  12. Cmd-Shift-D - Dial Marked services.
  13. Cmd-E - Edit Connection.
  14. Cmd-Shift-E - Toggle local echo.
  15. Cmd-F - Find.
  16. Cmd-G - Find Again.
  17. Cmd-H - Hangup.
  18. Cmd-K - Keyboard Buffer (for online conferences).
  19. Cmd-L - Clear the scroll buffer.
  20. Cmd-Shift-L - Clear the screen and scroll buffer.
  21. Cmd-M - Copy selection to modem.
  22. Cmd-N - Append selection to file.
  23. Cmd-Shift-N - Append selection to last append file for this service.
  24. Cmd-P - Print Selection.
  25. Cmd-Q - Quit.
  26. Cmd-R - Receive file with default receive protocol for this service.
  27. Cmd-S - Send file(s) with the default send protocol for this service.
  28. Cmd-T - Terminal settings.
  29. Cmd-V - Paste to modem.
  30. Cmd-W - Close Window.
  31. Cmd-X - Cut the selection to the clipboard.
  32. Cmd-Z - Undo (for desk accessories).
  33.  
  34. Cmd-UpArrow - Scroll up in the scroll buffer.
  35. Cmd-DownArrow - Scroll down in the scroll buffer.
  36. Cmd-Option-UpArrow - Scroll to top of scroll buffer.
  37. Cmd-Option-DownArrow - Scroll to bottom of scroll buffer.
  38.  
  39.  
  40. When the Dialing Directory window is in front:
  41. Cmd-C - Edit connection settings.
  42. Cmd-D - Dial highlighted service.
  43. Cmd-M - Mark the highlighted service.
  44. Cmd-Shift-M - Mark all services.
  45. Cmd-N - Add a New service.
  46. Cmd-Q - Queue dial (Dial marked services).
  47. Cmd-S - Change to settings for the highlighted service.
  48. Cmd-T - Terminal settings.
  49. Cmd-U - UnMark the highlighted service.
  50. Cmd-Shift-U - UnMark all services.
  51. Space or Down Arrow - move highlight down.
  52. Backspace or Up Arrow - move highlight up.
  53. Shift Click - toggle the mark for the service.
  54. Command Click - Make the service the startup default.
  55. Any letter - move highlight to matching service name.
  56. Double Click on a service - Edit connection settings.
  57.  
  58.  
  59. Keyboard Mapping
  60. On the MacPlus and Mac 512, ZTerm remaps the keyboard using the Toolbox's Script Manager using a custom KCHR resource.  This will allow you to use the Option key like a control key, and to add arrow keys to the antique original keyboard.  This remapping is enabled in the Terminal Preferences: use Option for Control.  Also, if you are using System 7 or later, you will need to install the ZTerm Keyboard file into your System to use Option for Control. 
  61.  
  62. The mapping below is only for MacPlus and earlier, when Option for Control is enabled:
  63. UP    Option =
  64. LEFT    Option [
  65. Right    Option ]
  66. Down    Option '    (These 4 make up a diamond on the old keyboards.)
  67. ESC    ` (Accent grave)
  68.  
  69.  
  70. For all keyboards:
  71. Cmd-Enter    send a break
  72. Control-Space NUL
  73. Control-2    NUL
  74. Control-4    ^/ (FS)
  75. Control-5    ^] (GS)
  76. Control-6    ^^ (RS)
  77. Control-7    ^_ (US)
  78.  
  79.  
  80. Extended keyboard:
  81. F1    VT220 F6    esc[17~
  82. F2    VT220 F7    esc[18~
  83. F3    VT220 F8    esc[19~
  84. F4    VT220 F9    esc[20~
  85. F5    VT220 F10    esc[21~
  86. F6    VT220 F11    esc[23~
  87. F7    VT220 F12    esc[24~
  88. F8    VT220 F13    esc[25~
  89. F9    VT220 F14    esc[26~
  90. F10    VT220 F15    esc[28~
  91. F11    VT220 F16    esc[29~
  92. F12    VT220 F17    esc[31~
  93. F13    VT220 F18    esc[32~
  94. F14    VT220 F19    esc[33~
  95. F15    VT220 F20    esc[34~
  96.  
  97. help        VT220 Find        esc[1~
  98. home        VT220 Ins here    esc[2~
  99. page up    VT220 Remove    esc[3~
  100. del        VT220 Sel        esc[4~
  101. end        VT220 Prev        esc[5~
  102. page down    VT220 Next        esc[6~
  103.  
  104.  
  105. Error and Other Messages
  106.  
  107. During a File Transfer
  108. CRC Err, Checksum Err - an error was encountered in the block of data and it must be resent.
  109. Got sector header xxx - an invalid character was received instead of the start of block character.
  110. Hdr CRC error, @ xxxx - an error occurred in the ZModem block header, xxxx is the current position in the received file.
  111. Data CRC error, @ xxxx - an error occurred in the ZModem data block, xxxx is the current position in the received file.
  112. No ACK on EOT - the receiver did not acknowledge the end of file message.
  113. Timeout on sector ACK - no acknowledge was received for the block in the allotted time.
  114. NAK on sector - the receiver got an error in the block and requests retransmission.
  115. Got burst for sector ACK - when waiting for the sector acknowledge, several characters were received (perhaps from line noise).
  116. No ACK, got a xxx - when waiting for acknowledge, the character xxx was received.
  117. Got ZRPOS = xxxx - the received got an error and requests retransmission starting at file offset xxxx.
  118. Error -120 or Directory Not Found - you probably need to set the Receive Folder.
  119.  
  120.  
  121. Modem Cables
  122. Macintosh (Mini DIN-8) Serial Connectors (Mac Plus and later)
  123. (This diagram is the connector on the end of a modem cable that you plug into your Mac.)
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135. Pin    Name        Description/Notes
  136. 1    HSKo        Output Handshake (from Zilog 8530 DTR pin)
  137. 2    HSKi/Ext Clk    Input Handshake (CTS) or TRxC (depends on 8530 mode)
  138. 3    TxD–        Transmit Data line
  139. 4    Ground
  140. 5    RxD–        Receive Data line
  141. 6    TxD+        Transmit Data line
  142. 7    GPi/DCD    General Purpose Input (not available on all models)
  143. 8    RxD+        Receive Data line; ground this line to emulate RS232
  144.  
  145.  
  146. Mac DIN-8 to MODEM - Hardware Handshaking
  147.  
  148. Mac            Modem (DB-25)
  149. 1 (HSKout)     ->    4 (RTS) & 20 (DTR)
  150. 2 (HSKin)    <-    5 (CTS)
  151. 3 (TxD-)    ->    2 (TxD)
  152. 4 (GND)    <->    7 (Signal Gnd)
  153. 5 (RxD-)    <-    3 (RxD)
  154. 6 (TxD+)    --    NONE
  155. 7 (GPi)    <-    8 (DCD) - not currently used by ZTerm
  156. 8 (RxD+)    <-    7 (Gnd)
  157.  
  158. Note: Hardware handshaking cables may vary slightly.  Pin 7 (GPi) is not currently used and I don’t know how many off-the-shelf cables have pin 7 connected.  A hardware handshake cable does not need pin 20 (DTR) on the modem connected to Mac pin 1 (in addition to pin 4 RTS), but most cables have this.  If you are using hardware handshake, you MUST remember to configure the modem to ignore the DTR line, using AT&D0 (that's a zero).  
  159.  
  160. Mac DIN-8 to MODEM - Typical Non-Hardware Handshaking
  161.  
  162. Mac            Modem (DB-25)
  163. 1 (HSKout)     ->    20 (DTR)
  164. 2 (HSKin)    <-    5 (CTS) & 8 (DCD)
  165. 3 (TxD-)    ->    2 (TxD)
  166. 4 (GND)    <->    7 (Signal Gnd)
  167. 5 (RxD-)    <-    3 (RxD)
  168. 6 (TxD+)    --    NONE
  169. 7 (GPi)    <-    NONE
  170. 8 (RxD+)    <-    7 (Gnd)
  171.  
  172. Macintosh 512, 128 Serial Connectors (DB-9)
  173. (This diagram is the connector on the end of a modem cable that you plug into your Mac.)
  174.  
  175.    
  176.  
  177.  
  178.  
  179.  
  180.  
  181. Pin    Name    Description/Notes
  182. 1    Ground
  183. 2    +5V     See Hardware reference for power limits
  184. 3    Ground
  185. 4    TxD+    Transmit Data line
  186. 5    TxD–    Transmit Data line
  187. 6    +12V    See Hardware reference for power limits
  188. 7    HSK    HandShaKe: CTS or TRxC, depends on Zilog 8530 mode
  189. 8    RxD+    Receive Data line; ground this line to emulate RS232
  190. 9    RxD–    Receive Data line
  191.  
  192. Mac 512, 128 (DB-9) to MODEM
  193.  
  194. Mac            Modem
  195. 1 (GND)    <->    1 (Gnd)
  196. 3 (GND)    <->    7 (Signal Gnd)
  197. 4 (TxD+)    --    NONE
  198. 5 (TxD-)    ->    2 (TxD)
  199. 6 (+12v)     ->    20 (DTR)
  200. 7 (HSKin)    <-    5 (CTS) & 8 (DCD)
  201. 8 (RxD+)    <-    7 (Signal Gnd)
  202. 9 (RxD-)    <-    3 (RxD)
  203.  
  204. Resources
  205. ZTerm does not save any of its settings in the ZTerm file.  All settings are stored in the PhoneList file.  You can lock the ZTerm application for some protection against viruses.
  206.  
  207. Binary File Type Detection
  208. When a file is received that is not in MacBinary format and is not text, ZTerm will see if it is a known type.  If it is, ZTerm will set the appropriate creator and type.  This is especially helpful to those transferring files from other computer systems.
  209.  
  210. There is a resource which contains file creator and types, with identifying information.  If you are handy with ResEdit, you can add additional types to this resource.  The resource is STR# 335.  Each string in the list is one binary type detector.  There are currently two types of detectors: type 0 looks for a signature (a sequence of bytes at the start of the file), and type 1 which just looks at the end of the file name (eg, the extension if its coming from ms-dos).  Type 0 is the preferred kind, but some binary files do not have a signature.  I may add additional types of detectors; if you have any ideas, let me know.
  211.  
  212. Each detector string begins with the detector type (0 or 1), then the 4 character creator, and the 4 character file type.  Type 0 then follows with the signature bytes (any length).  You should try to keep the signatures between 2 and 8 bytes.  Type 1 follows with the characters to match at the end of the file name (case insensitive).
  213.  
  214. Some examples:
  215.     For GIF files:    0BozoGIFfGIF8
  216.     For ARC files:    1arc*mArc.ARC
  217.  
  218. The first example will set binary files that start with GIF8 to creator “Bozo” and type “GIFf”.  The second example will set binary files whose name ends with “.ARC” to creator “arc*” and type of “mArc”.  This is for ArcMac from DogStar Software.
  219.  
  220. The current detectors handle GIF, ZIP, ARC, ZOO and some Lotus, Excel and Word file types.  There are a lot more binary file types that you might need to transfer to your Mac from other machines.  If you know the file signature or typical extension, and the appropriate Mac creator/type, please let me know so I can put them in a later release of ZTerm.
  221.  
  222. The default binary file type is normally a creator and type of ‘????’.  This is used if the file does not match any of the binary type detectors.  You can change this in the General Preferences.
  223.  
  224. Sending Files as Binary
  225. There is also a list of file types that should be uploaded as binary files.  This list is in STR# 330.  Each string in the list is a 4 character file type.  The current list includes GIF, ZIP, ARC, ???? and zBIN files.  TEXT files that have binary data in the first 128 bytes are also sent as binary.
  226.  
  227. Sounds
  228. ZTerm can play a sound for some events that occur while you are using it.  If the sounds are available, it will play a sound when you connect to a service, when a file transfer completes or when the BELL character is received.  These sounds are optional.  If the sound with the right name is not available, it will just play the normal beep.  It looks for the sound by its name.  The names it looks for are 'connect', 'filedone' and 'termbell'. I have included three sound files for system 7 as part of the ZTerm package that you can use, or you can use some other sounds.  
  229.  
  230. Trimming down ZTerm for floppy only system
  231. For those who are running on a floppy only system and want the smallest possible program file, here are some things you can remove from the ZTerm program with ResEdit.  Do not distribute any modified copies of ZTerm.
  232.  
  233. There are about 23k worth of fonts in the program.  If you are always using 9 point, you could remove all the 12 point FONTs.  If none of the internal fonts are found, it will use the Monaco font.  All of the STR# resources in the 600’s are used for balloon help; if you don’t use System 7, these are not needed.  
  234.  
  235.  
  236. About the Author
  237. I first started using computers when my brothers built a TVT video terminal in the mid 70’s.  We used it to call the university computer system.  Then we got an IMSAI 8080 with dual eight inch floppy drives!  I wrote a simple educational program in BASIC and had it published in Kilobaud magazine.  Just when I was ready to buy a newer CP/M machine, the IBM PC came out and I got one.  I programmed and played with it for a few years.  Then the Mac came out and I had to get one.  I started out programming in BASIC, working on a disk sector editor, a hex resource editor, a disassembler (my brother Bob did most of the disassembler part, I did the resource stuff) and making mods to MacTEP for my own use.  I wrote a program called ReadLisa that could read diskettes from the LISA computer and print or copy them to a Mac disk.  I uploaded this and actually received three payments for it.  
  238.  
  239. I decided to write ZTerm because I spent a lot of time telecommunicating, but I didn’t really like the software that was available.  Also, none at that time supported ZModem, which appeared to be the best thing to be using.  Thus began the never-ending journey of ZTerm.  
  240.  
  241. We recently moved to an old farmhouse (over 100 years old) in Maineville Ohio.  Its real close to the Kings Island amusement park and about 25 miles north of downtown Cincinnati.  I have been learning a lot about different types of electrical wiring used in the last 70 years!
  242.